home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / scrndisk.arc / SCRNDISK.DOC < prev    next >
Encoding:
Text File  |  1987-04-29  |  4.3 KB  |  73 lines
  1. -------------------------------------------------------------------------------
  2. |     ScrnDisk - Copyright (C) 1987 Ken Bell - All Rights Reserved.          |
  3. -------------------------------------------------------------------------------
  4.  
  5. ScrnDisk is a memory resident screen dump utility;  it dumps the contents of
  6. an 80 character text screen to a disk file. The disk file is opened just
  7. before and closed just after the dump.    Just before making itself resident,
  8. ScrnDisk requests the pathname of the file it is to write to .. any valid DOS
  9. pathname may be used; if the file does not exist, ScrnDisk will create it; if
  10. the file does exist, ScrnDisk will append each dump taken to the end of the
  11. file.  If the file is erased, ScrnDisk will create it again when the next dump
  12. is requested. It is recommended that a full pathname be specified, so that one
  13. may move across subdirectories freely, while always dumping to the same file.
  14. Although ScrnDisk does not accept arguments from its command line, input can
  15. be redirected from a file, so if you wish, you may create a (very small) file
  16. containing the pathname that you want scrndisk to use (for example, suppose we
  17. want to include ScrnDisk in an AUTOEXEC.BAT file, with the screen dump file
  18. always being C:\TEMP\SCRNDISK.DMP, the file containing the filespec being
  19. C:\UTIL\SCRNDISK.INI, and with ScrnDisk residing in C:\UTIL\SCRNDISK.COM;  we
  20. can create SCRNDISK.INI to contain the single line, C:\TEMP\SCRNDISK.DMP, and
  21. include in our AUTOEXEC.BAT file the line:
  22.  
  23.         C:\UTIL\SCRNDISK < C:\UTIL\SCRNDISK.INI
  24.  
  25. which will cause the pathname contained in SCRNDISK.INI to be accepted by
  26. ScrnDisk at the time it makes itself resident).  ScrnDisk occupies 3856
  27. bytes of memory when resident.
  28.  
  29.  
  30. The file produced by ScrnDisk contains 82 characters per line, since a full 80
  31. characters per line are assumed (i.e., that's the width of the screen line that
  32. you are dumping .. including any trailing blanks) to which ScrnDisk adds a
  33. carriage return and linefeed.  Therefore the DOS TYPE command will display the
  34. dump file as if it were double spaced, however a file viewing utility such as
  35. BROWSE will display the file correctly.  If you re-save the file with almost
  36. any editor (DAED is my favorite), the trailing blanks will be deleted.
  37.  
  38. The basic idea is that ScrnDisk points the BIOS interrupt 9 vector to its own
  39. code so that it can itercept all keyboard activity.  When a key is pressed,
  40. ScrnDisk checks whether a screen dump is being requested (i.e., if
  41. Ctrl-LeftShift-RightShift was pressed) and, if it is, stores the characters
  42. presently on the screen in a buffer, appends a carriage return and linefeed to
  43. each line of text, and then writes the contents of the buffer to disk.    If any
  44. other key was pressed, ScrnDisk simply passes the interrupt request on to the
  45. original BIOS keyboard handler.
  46.  
  47. ScrnDisk will not dump if the video mode is not an 80 character text mode (2,
  48. 3, or 7).  It has been tested on an XT clone with a Hercules clone board,
  49. however it is designed to work properly with a CGA board also.    I have no idea
  50. what it will do in the presence of an EGA board. It seems fully compatible
  51. with SIMCGA (that indispensible CGA emulation program for the Herc board) and
  52. with DOS-EDIT.
  53.  
  54. ScrnDisk does NOT check to see if it is already resident.  I recommend that if
  55. you decide to use it, include it in your AUTOEXEC.BAT file so that you don't
  56. load it twice by mistake. To remove it from memory, you must reboot DOS.
  57.  
  58. This program may not be sold, rented, or used commercially without my express
  59. written permission.  No fee may be collected for its distribution.  It may,
  60. however, be distributed FREE of all charges via BBS upload or any other
  61. method. If you really like it, use it, and want to support it, please don't
  62. send me money .. send a contribution, in whatever amount you feel appropriate,
  63. to a good charitable organization.  My personal favorites are Coalition for
  64. the Homeless, Partnership for the Homeless, and the Multiple Sclerosis
  65. Society. Feel free to support another charity if you prefer.
  66.  
  67. I would be happy to receive comments, suggestions, and reports of (yechh!)
  68. BUGS.
  69.  
  70. -------------------------------------------------------------------------------
  71. |       Ken Bell .. 232 East Sixth Street .. New York, NY 10003          |
  72. -------------------------------------------------------------------------------
  73.